SetModalDialogEventMask1

SetModalDialogEventMask

Specifies the events to be received by the ModalDialog function.

pascal OSStatus SetModalDialogEventMask (
DialogPtr inDialog,
EventMask inMask);

inDialog

A value of type DialogPtr . Pass a pointer to the dialog box for which you wish to set the event mask.

inMask

An unsigned 16-bit integer of type EventMask . Pass the desired mask value(s) for the event(s) you wish the dialog box to receive. See Inside Macintosh: Macintosh Toolbox Essentials for descriptions of event mask constants.

function result

A result code. See Result Codes for the Mac OS 8.5 Dialog Manager .

DISCUSSION

Your application can use the SetModalDialogEventMask function to specify the events received by the ModalDialog function for a given modal dialog box. This allows your application to specify additional events that are not by default received by ModalDialog , such as disk-inserted events and operating-system events. If you use SetModalDialogEventMask to change the ModalDialog function's event mask, you should pass ModalDialog a pointer to your own event filter function to handle any added events.

VERSION NOTES

Available with Mac OS 8.5 and later.